home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / bbs / msrch11.zip / SAMPLE2.CFG < prev    next >
Text File  |  1996-07-07  |  8KB  |  176 lines
  1.                               Sample MULTSRCH.CFG
  2.                        (Document Menu Configuration File)
  3.  
  4. Unregistered <--------------------- Your name
  5. 0 <-------------------------------- Registration code
  6. 3  <------------------------------- Number of available files
  7. 28 <------------------------------- Number of files per page in menu
  8. DSZ <------------------------------ Select download protocol
  9. c:\pcb\node1\caller <-------------- Path to file
  10. Node 1 Caller Log (Sysop Only) <--- Menu title
  11. 100 <------------------------------ Security to access file
  12. 1 <-------------------------------- Category number
  13. c:\text\gamefaqs.txt
  14. `BRIGHT RED`Game FAQ Sheet
  15. 0
  16. 2
  17. c:\pcb\node1\newreg.txt
  18. Questionaire Results (Sysop Only)
  19. 100
  20. 3
  21.  
  22. ------------------------------------------------------------------------------
  23. NOTE:  Although you can edit this  file manually, MULTEDIT.EXE is included and
  24. provides  menu driven editing capability. It  will automatically keep track of
  25. and  update  the number of documents you  have available. However, if for some
  26. reason  you need to manually edit the  file, the following explanation of each
  27. line will help you do this.
  28. ------------------------------------------------------------------------------
  29.  
  30.               *** Quick explanation of the above configuration ***
  31.  
  32. In this sample configuration three files will be made available for viewing or
  33. searching and will be placed in categories 1, 2, and 3, respectively.
  34.  
  35. Files  one  and  three require a high level  of  security to access, such as a
  36. sysop  or  co-sysop might have. The second  file  will be available to all. In
  37. this  configuration up to 28 file titles will be displayed on a single page if
  38. more are added to the list.
  39.  
  40. Download capability is enabled using DSZ.
  41.  
  42. ==============================================================================
  43.                                *** IMPORTANT ***
  44.     The third line MUST contain the EXACT number of files which you plan to
  45.                  have available in the menu!  No more, no less.
  46.                Do NOT skip any lines or add spaces between lines.
  47. ==============================================================================
  48.  
  49. FIRST 5 LINES OF ABOVE EXAMPLE:
  50.  
  51. Line 1:
  52.         The  EXACT  name you put on  your registration form. This MUST include
  53.         any  spaces or special characters and is case sensitive! This line has
  54.         no effect in the unregistered version, but must contain something.
  55.  
  56. Line 2:
  57.         The  registration number. If this version has not been registered then
  58.         it should be zero.
  59.  
  60. Line 3:
  61.         The  EXACT  number  of files that you  wish  to  make available in the
  62.         system. Maximum of 225. You must change this number every time you add
  63.         or  remove  files. Specifying more files  than you have available will
  64.         cause unpredictable (read that UNPLEASANT!) results. MULTEDIT.EXE will
  65.         update this value automatically as entries are added or deleted.
  66.  
  67. Line 4:
  68.         Number  of files you wish to display  on each page. The maximum number
  69.         is  28, and this is the recommended value. If you specify more than 28
  70.         files  per page the system will limit you to 28. This is to allow room
  71.         at  the  bottom  for menu choices.  This  option affects graphics mode
  72.         only.
  73.  
  74. Line 5:
  75.         Enable download capability by entering DSZ, GSZ, or FDSZ here. Disable
  76.         by  entering  NO. Text must be exact  and is case specific. The prompt
  77.         will  either show the user an option  to download or not, depending on
  78.         what  you specify here. When creating MULTSRCH.CFG with the editor for
  79.         the first time the default is NO.
  80.  
  81.  
  82. FILE INFORMATION IN THE ABOVE EXAMPLE:
  83.  
  84. Now  enter the information for each file  you wish to make available. It takes
  85. four  lines  to  fully describe each one, and  you  must  not skip or omit any
  86. lines.  The  example configuration above specifies  three files, the first and
  87. third  set  to  a high security level so  that  only the sysop or co-sysop has
  88. access. The second file is available to anyone.
  89.  
  90. First Line:
  91.         The  complete  path  to the file,  including  the file name. The path,
  92.         including  file name, must be 80 characters  or less. To view the file
  93.         as  an ANSI graphics file the file name must include ".ANS". Otherwise
  94.         the file is assumed to be ASCII text and will be treated accordingly.
  95.  
  96. Second  Line:
  97.         The name you wish to have displayed in the menu. In the second example
  98.         above  you will see `BRIGHT RED` included  in the file name. This will
  99.         cause  the color of this title to be bright red instead of the default
  100.         yellow. See the section on color customization below for more details.
  101.         You  should keep the number of displayed characters to 34 or less. You
  102.         are  limited  to  a total of  80  characters for the whole description
  103.         including color info (which is not actually displayed in the menu).
  104.  
  105. Third  Line:
  106.         The  security  level  required to access  the  file.  Use this to give
  107.         special  clearance to files such as  caller logs, etc., that you might
  108.         not  want  everyone to see. Security  levels  equal to or greater than
  109.         this value will have clearance.
  110.  
  111. Fourth Line:
  112.         The  category number in which you wish  the file to appear. If you are
  113.         not  using  the optional category menu, then  any  number from 1 to 20
  114.         should  be put here. If you later  decide to add categories and create
  115.         MAIN.CFG,  the number you have entered on this line will be the number
  116.         of  the  category  in which the  document  will be displayed. When you
  117.         create  MAIN.CFG  you  will list the  category  names you wish to use.
  118.         Count  down  the list and put the  number of the category here, on the
  119.         fourth  line of the file description.  In the above example the second
  120.         file  is associated with category  2, "Gaming Information", defined in
  121.         SAMPLE1.CFG. (This would be MAIN.CFG for a real installation).
  122.  
  123.  
  124. COLOR CUSTOMIZATION:
  125. You  may  change  the  color of the  file  listing  text  by including special
  126. delimited text in the description on line 2 of the file entry. (See the second
  127. file  entry in the example.) To change the  color attributes of a file name in
  128. the  listing  you simply use the backwards  apostrophe  (`) as a delimiter. Be
  129. careful  not  to use the regular apostrophe  (')  instead! This will not work.
  130. Here  is a list of the "special text" that you can include in the file name to
  131. change the colors.
  132.  
  133. BLACK
  134. BLUE
  135. GREEN
  136. CYAN
  137. RED
  138. MAGENTA
  139. BROWN
  140. WHITE (gray)
  141. BRIGHT BLACK (dark gray)
  142. BRIGHT BLUE
  143. BRIGHT GREEN
  144. BRIGHT CYAN
  145. BRIGHT RED
  146. BRIGHT MAGENTA
  147. BRIGHT YELLOW
  148. BRIGHT WHITE (white)
  149.  
  150. Additionally  you  may make the characters  flash by including FLASHING before
  151. the  color.  You  may also change the  background  with  the ON keyword (ON is
  152. actually  optional,  but  I  like it because  it's  easier  to  read the color
  153. instructions). Here are some examples on how to use colors.
  154.  
  155. 1) Change foreground color of text to bright blue:
  156. `BRIGHT BLUE`This is a test
  157. Changes the entire string to bright blue on a black background.
  158.  
  159. 2) Change foreground color to dark red on a yellow background.
  160. `RED ON BRIGHT YELLOW`This is a test
  161. Changes the entire string to red on a yellow background.
  162. It could also be written as:
  163. `RED BRIGHT YELLOW`This is a test
  164. Note the elimination of the optional ON.
  165.  
  166. 3) Use flashing text and change background and foreground colors.
  167. `FLASHING RED ON BRIGHT YELLOW'This is a test
  168. Changes entire string to flashing red on a yellow background.
  169.  
  170. 4) Mix and match.
  171. `BRIGHT RED`This is a `FLASHING BRIGHT GREEN`test
  172. First  three words are bright red on black. "test" is flashing bright green on
  173. black background.
  174.  
  175. Experiment and have some fun!
  176.